

	  XTCLOCK2.ZIP is intended  as a survival kit  for the user
 	who somehow got stuck  with  an XT clock  card  and no
	driver software. Files included are:

			SETCLOCK.C
			SETCLOCK.EXE
			SETCLOCK.BAS
			GETCLOCK.C
			GETCLOCK.EXE
			GETCLOCK.BAS
			SEEPORTS.BAS
			DOSNIX.TXT
			README.1ST   (This file)

	  These programs have  been written for a clock card with
	the following port  configuration:

			&h242   Second
			&h243   Minute
			&h244   Hour
			&h246   Day
			&h247   Month
			&h249   Year

	Most clock cards and I/O cards currently available seem to fit
	this configuration.  The manual will probably give a base port 
	address	of &h240.  Many cards are jumper selectable for either
	&h240 or &h340.

	  If you are  sure your clock  card matches this configuration
	you can use SETCLOCK.EXE and GETCLOCK.EXE without modification.
	To initialize your clock card, run SETCLOCK.EXE and follow the
	instructions.  Then run GETCLOCK to set the DOS time and date.
	You can run GETCLOCK from your AUTOEXEC.BAT file to set the DOS
	time and date when booting your computer.  If your card does not 
	match this  configuration  you can  modify either the  C or BASIC
	source files, depending on your compiler.  The BASIC source files
	can be used for either GWBASIC or QuickBASIC.

	  If you  are  not  sure how your card is configured but you
	have at  least  one  port address, you can use SEEPORTS.BAS
	to display your ports.  If you have the right ports displayed
	you will probably see them incrementing in  strange jumps.
	This is Binary Coded Decimal. The way BCD works  is the
	four low order  bits represent the ones digit and  the four
	high  order bits represent the  tens digit. 

	  If you  are looking  at a  port that  is  incrementing at about
	the right rate to represent seconds and it counts to 79 and drops
	back  to zero, you got  it.  If  the  next port increments by
	one, at the  same time, it is  probably  the  one  for  minutes.
	You can  use  the BASIC OUT statement  to write into  a port
	and see if  you  can toggle another  port. Eventually you should
	be able  to figure  out what each  port  does.  Many cards do not
	increment the year but still store it at &h249.

	  These programs are provided as a public service by the author
	of DOSNIX.  For a description of DOSNIX and what it can do for
	you, read DOSNIX.TXT.

			Gerald M. Vrooman
			Chenango Forks, N.Y.

